home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / u_man / cat1 / dmedia / movieplayer.z / movieplayer
Text File  |  1998-10-30  |  16KB  |  331 lines
  1.  
  2.  
  3.  
  4. mmmmoooovvvviiiieeeeppppllllaaaayyyyeeeerrrr((((1111))))                                                  mmmmoooovvvviiiieeeeppppllllaaaayyyyeeeerrrr((((1111))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      mmmmoooovvvviiiieeeeppppllllaaaayyyyeeeerrrr, mmmmeeeeddddiiiiaaaappppllllaaaayyyyeeeerrrr - player for media files
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      mmmmeeeeddddiiiiaaaappppllllaaaayyyyeeeerrrr [oolki----ooooppppttttiiiioooonnnnssss] [----nnnnooooffffoooorrrrkkkk] [----NNNN] [----vvvv] [----zzzz zzzzoooooooommmmffffaaaaccccttttoooorrrr] [----llll llllooooooooppppccccoooouuuunnnntttt]
  13.      [----WWWW sssswwwwiiiinnnnggggccccoooouuuunnnntttt] [----bbbb bbbbaaaannnnddddwwwwiiiiddddtttthhhh] [mediafile]
  14.  
  15. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  16.      _m_e_d_i_a_p_l_a_y_e_r, also known as _m_o_v_i_e_p_l_a_y_e_r for backwards compatibility, is a
  17.      player application for SGI, QuickTime, AVI and MPEG-1 movie files, as
  18.      well as Audio files supported by the SGI audiofile library (eg, AIFF,
  19.      AIFC, WAVE, MPEG1-audio, Sun .snd/Next .au, etc.).
  20.  
  21.      _m_e_d_i_a_p_l_a_y_e_r can be used as a stand-alone application with a graphic user
  22.      interface for interactive control of the playback. It can also be used as
  23.      a command line utility for launching playback from within other
  24.      applications, such as IRIS Showcase or your favorite World Wide Web
  25.      browser, or from your own shell scripts.
  26.  
  27. CCCCOOOOMMMMMMMMAAAANNNNDDDD LLLLIIIINNNNEEEE AAAARRRRGGGGUUUUMMMMEEEENNNNTTTTSSSS AAAANNNNDDDD FFFFLLLLAAAAGGGGSSSS
  28.      ----nnnnooooffffoooorrrrkkkk
  29.           Specifies that _m_e_d_i_a_p_l_a_y_e_r should run in the foreground, when
  30.           invoked from the shell.  This option is consistent with the rest of
  31.           the bundled media tools. The deprecated option -f is equivalent and
  32.           is provided for backward compatibility.
  33.  
  34.      ----NNNN   Provide no window borders for the visual portion of the playback.
  35.           Even though the window has no border, you can still use the standard
  36.           window manager commands to move and close the window.
  37.  
  38.      ----vvvv   Specifies view-only mode.  In this mode, the menu bar and transport
  39.           controls are hidden, leaving only the display of the media inside
  40.           the window (if needed).  By using the pop-up menu on button 3
  41.           (usually the right button), the user may show these at a later time.
  42.           This pop-up menu will also enable the user to save the file under a
  43.           different name, or quit the application.
  44.  
  45.      ----zzzz zzzzoooooooommmmffffaaaaccccttttoooorrrr
  46.           Specifies zoom factor for the visual display of the media.  The size
  47.           of the display will be scaled up or down by the specified amount in
  48.           both the X and Y dimensions.  The zoom factor can be expressed in a
  49.           floating point value from 0.1 to 4.0. (Not applicable to audio
  50.           files.)
  51.  
  52.      ----llll llllooooooooppppccccoooouuuunnnntttt
  53.           Play the movie the specified number of times, then exit.  A value of
  54.           0 means to loop forever.  This option automatically places the
  55.           player into view-only mode.
  56.  
  57.      ----WWWW sssswwwwiiiinnnnggggccccoooouuuunnnntttt
  58.           Play the movie forward and reverse the specified number of times,
  59.           then exit.  A value of 0 means to alternately play the media
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. mmmmoooovvvviiiieeeeppppllllaaaayyyyeeeerrrr((((1111))))                                                  mmmmoooovvvviiiieeeeppppllllaaaayyyyeeeerrrr((((1111))))
  71.  
  72.  
  73.  
  74.           forwards then backwards forever.  A swing count value of 2 will play
  75.           the media forward once, backward once, and then quit the program.
  76.           This option automatically places the player into view-only mode.
  77.  
  78.      ----bbbb bbbbaaaannnnddddwwwwiiiiddddtttthhhh
  79.           Play the movie with the given audio bandwidth, which may be "f"
  80.           (full), "h" (half), or "q" (quarter).  Lower bandwidths require less
  81.           computation and may result in better video quality.  This option is
  82.           currently used for MPEG-1 movies only. The default is half
  83.           bandwidth.
  84.  
  85. RRRREEEESSSSOOOOUUUURRRRCCCCEEEESSSS
  86.      If you want private customizations, create or edit the file to
  87.      $HOME/.desktop-`hostname`/MediaPlayer to add resources with your desired
  88.      values (eg, "audioBandwidth: full", etc).
  89.  
  90. SSSSUUUUPPPPPPPPOOOORRRRTTTTEEEEDDDD TTTTYYYYPPPPEEEESSSS OOOOFFFF MMMMEEEEDDDDIIIIAAAA
  91.      QQQQuuuuiiiicccckkkkTTTTiiiimmmmeeee MMMMoooovvvviiiieeee
  92.           _m_e_d_i_a_p_l_a_y_e_r is able to play QuickTime movies for which an available
  93.           decompressor has been installed.  Such decompressors may include one
  94.           of the following:
  95.  
  96.           _C_i_n_e_p_a_k
  97.           _A_p_p_l_e _A_n_i_m_a_t_i_o_n (_R_L_E _e_n_c_o_d_i_n_g)
  98.           _A_p_p_l_e _V_i_d_e_o (_R_P_Z_A _e_n_c_o_d_i_n_g)
  99.           _A_p_p_l_e _C_o_m_p_a_c_t _V_i_d_e_o
  100.           _A_p_p_l_e _P_h_o_t_o (_n_o_n-_i_n_t_e_r_l_a_c_e_d _J_P_E_G) _N_o_t_e *
  101.           _S_t_a_n_d_a_r_d _Q_u_i_c_k_T_i_m_e _M_o_t_i_o_n _J_P_E_G_A (_M_J_P_E_G_A)
  102.           _I_n_t_e_l _I_n_d_e_o _V_i_d_e_o (_R_3._2)
  103.           _D_V/_D_V_C_P_r_o _d_a_t_a
  104.           ``_R_a_w'' (_u_n_c_o_m_p_r_e_s_s_e_d)
  105.  
  106.           Note *: JPEG decompression is done using hardware on O2 machines if
  107.           the image size is a multiple of 8 high and 8 wide.
  108.  
  109.           In addition, _m_e_d_i_a_p_l_a_y_e_r can play movies in the QuickTime format
  110.           that have been compressed with the Cosmo Compress board, using
  111.           hardware playback support on Indy's with Cosmo Compress boards, or
  112.           on O2 systems using its built in hardware support.  This interlaced
  113.           JPEG encoding will not be playable on other platforms supporting
  114.           QuickTime; for cross-platform use, these movies should be converted
  115.           to either Motion JPEG-A or Photo-JPEG, or one of the other standard
  116.           compression schemes (uncompressed, CinePak, etc).
  117.  
  118.           _m_e_d_i_a_p_l_a_y_e_r does not require that the QuickTime file be flattened
  119.           before it can be played.  However, the resource fork must exist in
  120.           its proper location.  If the file was copied to the IRIX file system
  121.           using the IRIX Interactive Desktop, the appropriate resource files
  122.           should be in place. (But note that rcp or cp will _n_o_t automatically
  123.           copy the resource fork file!) However, it should be noted that, in
  124.           many cases, playback performance as well as file size will be
  125.           improved on flattened files. Therefore, before publishing movies, it
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. mmmmoooovvvviiiieeeeppppllllaaaayyyyeeeerrrr((((1111))))                                                  mmmmoooovvvviiiieeeeppppllllaaaayyyyeeeerrrr((((1111))))
  137.  
  138.  
  139.  
  140.           is generally advisable to flatten them. _m_o_v_i_e_m_a_k_e_r(_1)'s ``Export
  141.           As'' command, as well as _m_e_d_i_a_c_o_n_v_e_r_t and _d_m_c_o_n_v_e_r_t can flatten
  142.           QuickTime movies.
  143.  
  144.           _m_e_d_i_a_p_l_a_y_e_r now also supports playing QuickTime movies with
  145.           compressed audio, for the audio compression schemes IMA4:1 (common
  146.           on some sites on the Internet), and DV-Audio (normally only seen in
  147.           DV/DVCPro QuickTime files).
  148.  
  149.      SSSSGGGGIIII MMMMoooovvvviiiieeee
  150.           When the Cosmo Compress hardware is present, _m_e_d_i_a_p_l_a_y_e_r will play
  151.           interlaced JPEG files created by or for use with Cosmo Compress.
  152.           These movies will also play using the built in hardware support in
  153.           the O2 platform.
  154.  
  155.      MMMMPPPPEEEEGGGG----1111 vvvviiiiddddeeeeoooo bbbbiiiittttssssttttrrrreeeeaaaammmm,,,, MMMMPPPPEEEEGGGG----1111 ssssyyyysssstttteeeemmmmssss ((((aaaauuuuddddiiiioooo////vvvviiiiddddeeeeoooo)))) bbbbiiiittttssssttttrrrreeeeaaaammmm
  156.           _m_e_d_i_a_p_l_a_y_e_r supports playback of MPEG-1 movies (video bitstreams, or
  157.           systems bitstreams with a video track).  Unlike SGI and QuickTime
  158.           movies, MPEG-1 movies generally do not include index table
  159.           information which facilitates track length determination and frame-
  160.           accurate random access.
  161.  
  162.      AAAAVVVVIIII MMMMoooovvvviiiieeee
  163.           _m_e_d_i_a_p_l_a_y_e_r is able to play AVI movies that use these compression
  164.           schemes:  JPEG, Apple Compact Video, Indeo R3.2 or none
  165.           (uncompressed).
  166.  
  167.      DDDDVVVV////DDDDVVVVCCCCPPPPrrrroooo DDDDIIIIFFFF MMMMoooovvvviiiieeeessss
  168.           _m_e_d_i_a_p_l_a_y_e_r is able to play DV or DVCPro DIF movies (streams).  This
  169.           is an industry-standard raw file format commonly used to store data
  170.           copied from DVC format camcorders and VCRs. It can contain image and
  171.           audio data.
  172.  
  173.      AAAAuuuuddddiiiioooo FFFFiiiilllleeeessss
  174.           _m_e_d_i_a_p_l_a_y_e_r supports all file formats supported by the SGI audio
  175.           file library, including AIFF-C, AIFF, NeXT/Sun format, WAVE, BICSF,
  176.           MPEG1 bitsream, SoundDesigner2, and others. Please see
  177.           aaaaffffIIIInnnniiiittttFFFFiiiilllleeeeFFFFoooorrrrmmmmaaaatttt(3dm) for more details.
  178.  
  179. KKKKEEEEYYYYBBBBOOOOAAAARRRRDDDD CCCCOOOOMMMMMMMMAAAANNNNDDDDSSSS
  180.      _m_e_d_i_a_p_l_a_y_e_r and _m_o_v_i_e_m_a_k_e_r support left-arrow and right-arrow keyboard
  181.      equivalents for "step forward" and "step backward" when viewing a movie
  182.      file. Note that this functionality applies only to movie files, not audio
  183.      files.
  184.  
  185. CCCCOOOOPPPPYYYY SSSSUUUUPPPPPPPPOOOORRRRTTTT
  186.      When the user makes a selection using the timeline, _m_e_d_i_a_p_l_a_y_e_r will
  187.      activate the "Copy" entry on the "Edit" menu. _m_e_d_i_a_p_l_a_y_e_r supports
  188.      copying the current selection to the X-Clipboard, so that users may paste
  189.      from _m_e_d_i_a_p_l_a_y_e_r into other X-based applications, such as moviemaker,
  190.      imgworks, soundeditor, inperson, etc.  When a user chooses "Copy,"
  191.      _m_e_d_i_a_p_l_a_y_e_r will advertise a number of formats of data that it makes
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202. mmmmoooovvvviiiieeeeppppllllaaaayyyyeeeerrrr((((1111))))                                                  mmmmoooovvvviiiieeeeppppllllaaaayyyyeeeerrrr((((1111))))
  203.  
  204.  
  205.  
  206.      available to other applications to paste:
  207.  
  208.      MMMMoooovvvviiiieeee DDDDaaaattttaaaa
  209.           A Movie of the current selection. (SGI or QuickTime)
  210.  
  211.      AAAAuuuuddddiiiioooo DDDDaaaattttaaaa
  212.           An audiofile of the current selection, assuming that the current
  213.           selection contains audio data.
  214.  
  215.      SSSSttttiiiillllllll IIIImmmmaaaaggggeeee DDDDaaaattttaaaa
  216.           A still image representing the first frame of the current selection,
  217.           assuming that the current selection contains a data that can be
  218.           represented as an image.
  219.  
  220. IIIIMMMMPPPPOOOORRRRTTTTAAAANNNNTTTT CCCCHHHHAAAANNNNGGGGEEEE
  221.      _m_e_d_i_a_p_l_a_y_e_r supports all of the command-line options that were supported
  222.      in _m_o_v_i_e_p_l_a_y_e_r (which _m_e_d_i_a_p_l_a_y_e_r obsoletes) with one notable exception.
  223.      The command flag -S is no longer supported.  Use the standard X -geometry
  224.      method instead.  These should proceed the _m_e_d_i_a_p_l_a_y_e_r command-line
  225.      options.
  226.  
  227.  
  228. EEEEXXXXAAAAMMMMPPPPLLLLEEEESSSS
  229.      To show a simple movie window at a specific area on the screen, without
  230.      borders or a control panel, use a command like:
  231.  
  232.           mmmmeeeeddddiiiiaaaappppllllaaaayyyyeeeerrrr ----ggggeeeeoooommmmeeeettttrrrryyyy ++++111100000000++++111100000000 ----vvvv ----NNNN mmmmoooovvvviiiieeeeffffiiiilllleeee
  233.  
  234.      To make a movie appear on the screen, play itself three times, and
  235.      disappear, use a command like:
  236.  
  237.           mmmmeeeeddddiiiiaaaappppllllaaaayyyyeeeerrrr ----ggggeeeeoooommmmeeeettttrrrryyyy ++++111100000000++++111100000000 ----llll 3333 mmmmoooovvvviiiieeeeffffiiiilllleeee
  238.  
  239.  
  240. TTTTRRRRAAAADDDDEEEEMMMMAAAARRRRKKKKSSSS
  241.      _C_i_n_e_p_a_k is a trademark of Radius, Inc.
  242.  
  243.      _A_p_p_l_e is a registered trademark and _Q_u_i_c_k_T_i_m_e is a trademark of Apple
  244.      Computer, Inc.
  245.  
  246.      _I_n_d_e_o is a registered trademark of Intel Corp.
  247.  
  248.  
  249. NNNNOOOOTTTTEEEESSSS
  250.      The 'Maintain Aspect Ratio' menu item only affects the graphics display
  251.      of movies.  It has no effect on video-output or Cosmo hardware playback.
  252.  
  253.  
  254. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  255.      soundplayer(1), capture(1), moviemaker(1), soundeditor(1),
  256.      showcase(1), mediaconvert(1), dmconvert(1), makemovie(1),
  257.      dminfo(1), imgworks(1), afInitFileFormat(3dm)
  258.  
  259.  
  260.  
  261.                                                                         PPPPaaaaggggeeee 4444
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268. mmmmoooovvvviiiieeeeppppllllaaaayyyyeeeerrrr((((1111))))                                                  mmmmoooovvvviiiieeeeppppllllaaaayyyyeeeerrrr((((1111))))
  269.  
  270.  
  271.  
  272.  
  273.  
  274.  
  275.  
  276.  
  277.  
  278.  
  279.  
  280.  
  281.  
  282.  
  283.  
  284.  
  285.  
  286.  
  287.  
  288.  
  289.  
  290.  
  291.  
  292.  
  293.  
  294.  
  295.  
  296.  
  297.  
  298.  
  299.  
  300.  
  301.  
  302.  
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.                                                                         PPPPaaaaggggeeee 5555
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.